package com.dawn.module.cms.service.category;

import java.util.*;
import javax.validation.*;

import com.dawn.framework.common.util.collection.CollectionUtils;
import com.dawn.module.cms.controller.admin.category.vo.*;
import com.dawn.module.cms.controller.app.category.vo.AppCategoryListReqVO;
import com.dawn.module.cms.controller.app.category.vo.AppCategoryRespVO;
import com.dawn.module.cms.dal.dataobject.category.CategoryDO;
import com.dawn.framework.common.pojo.PageResult;

/**
 * 类别管理 Service 接口
 *
 * @author mamba 4 left
 */
public interface CmsCategoryService {

    /**
     * 创建类别管理
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createCategory(@Valid CategorySaveReqVO createReqVO);

    /**
     * 更新类别管理
     *
     * @param updateReqVO 更新信息
     */
    void updateCategory(@Valid CategorySaveReqVO updateReqVO);

    /**
     * 删除类别管理
     *
     * @param id 编号
     */
    void deleteCategory(Long id);

    /**
     * 获得类别管理
     *
     * @param id 编号
     * @return 类别管理
     */
    CategoryDO getCategory(Long id);

    /**
     * 获得类别管理分页
     *
     * @param pageReqVO 分页查询
     * @return 类别管理分页
     */
    PageResult<CategoryDO> getCategoryPage(CategoryPageReqVO pageReqVO);


    /**
     * 获得类目列表,
     *
     * @param exportReqVO 查询条件
     * @return 类目列表
     */
    List<CategoryDO> getCategoryList(AppCategoryListReqVO exportReqVO);

    /**
     * 获得类目列表树,
     *
     * @param exportReqVO 查询条件
     * @return 类目列表
     */
    List<AppCategoryRespVO> getCategoryTree(AppCategoryListReqVO exportReqVO);


    /**
     * 获得类目列表
     *
     * @param ids 编号
     * @return 类目列表
     */
    List<CategoryDO> getCategoryList(Collection<Long> ids);

    /**
     * 获得指定编号的类目 Map
     *
     * @param ids 部门编号数组
     * @return 部门 Map
     */
    default Map<Long, CategoryDO> getCategoryMap(Collection<Long> ids) {
        List<CategoryDO> list = getCategoryList(ids);
        return CollectionUtils.convertMap(list, CategoryDO::getId);
    }
}